home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / x11 / games / xboing2.4.readme < prev    next >
Text File  |  1997-08-26  |  8KB  |  206 lines
  1.  
  2.               .o8                  o8o                            ooooo ooooo 
  3.              "888                  `"'                            `888' `888' 
  4.  oooo    ooo  888oooo.   .ooooo.  oooo  ooo. .oo.    .oooooooo     888   888  
  5.   `88b..8P'   d88' `88b d88' `88b `888  `888P"Y88b  888' `88b      888   888  
  6.     Y888'     888   888 888   888  888   888   888  888   888      888   888  
  7.   .o8"'88b    888   888 888   888  888   888   888  `88bod8P'      888   888  
  8.  o88'   888o  `Y8bod8P' `Y8bod8P' o888o o888o o888o `8oooooo.     o888o o888o 
  9.                                                     d"     YD                 
  10.                                                     "Y88888P'                 
  11.  
  12.                          Version 2.4 - 22nd Nov 1996
  13.  
  14.  
  15. Description
  16. -----------
  17.  
  18. XBoing is a blockout type game where you have a paddle which you use to
  19. bounce a ball around the game area blowing up blocks with the ball. You win by
  20. obtaining points for each block destroyed and each level completed. The person
  21. with the highest score wins.
  22.  
  23. XBoing was started like many other projects to learn Xlib better. I had the 
  24. XPM library and was already using it in a Motif application. I thought that it
  25. would be cool to have nice colour pictures/animations in an Xlib game. So I 
  26. did. Without the XPM library I would be still playing with the colours I think.
  27.  
  28. Please read the manual page as the manual has some important game play 
  29. information. 
  30.  
  31. WARNING: This game requires a lot of grunt to run well. If someone is doing
  32.          a compile or the load is large then expect the game to be a bit
  33.          bumpy and hard to play. Sorry about that. ;-|
  34.  
  35. Please see version.doc for information on this version.
  36.  
  37. Changes since V2.3
  38. ------------------
  39.  
  40. - Added more randomness to the ball bouncing code.
  41. - Reduced the autotilt timeout time from 10000 to 5000
  42. - If you hit a solid block within red shading it will go away. New Feature
  43. - Added some ball code to fix bouncing strangely when hitting two blocks
  44.   square on by spiegl@appl-math.tu-muenchen.de Thanks.
  45. - Added hours into the highscore output for time played!! Fixed spelling
  46.   mistake in instructions.
  47. - The bug with the eyedude has been fixed where you could clock up millions
  48.   by shooting where a dead eyedude was! MAJOR BUG
  49. - removed all names in the bitmaps that are like slate grey to slategrey
  50. - Added some code sent by Ulrich Kuehn  kuehn@math.uni-muenster.de that helps
  51.   make the speed control in SleepSync() work much better.
  52. - Fixed a bug in the wrap around of the levels when the maximum level was done.
  53.   Thanks GLen Pringle (pringle@cs.monash.edu.au)
  54. - Changed some things to do with Linux and some typos with ideas from
  55.   Thomas Ott (thommy@rz.fh-augsburg.de)
  56. - Level 26 made a bit easier!
  57. - Changed the highscore version number as all old scores will be invalid now
  58.   that the cheating bug where you can get millions is gone I hope.
  59. - Add audio support for UnixWare 2.02 as suggested endrew@colargol.idb.hist.no
  60. - added 15 new levels to make the total 80!
  61. - Instructions page stays up longer to read it now.
  62. - minor tweaks and twiddles here and there ...
  63.  
  64. Requirements
  65. ------------
  66.  
  67. The XPM library. XPM is currently at version 3.4c I think.
  68.  
  69. A COLOUR X display. I may fix it to use other visuals later. ie: grey. mono
  70.  
  71. An ansi or non-ansi compiler. Ansi is better, try gcc.
  72.  
  73. Also note that if you are on a Sun machine the xnews server is not the
  74. quickest and you may experience delays in the game due to its heavy use
  75. of pixmaps etc. I suggest playing it with the MIT X Server - hassle I know
  76. if you use other Sun software that requires news etc.
  77.  
  78. Note: It will always be a bit slower on a network so playing on the host
  79.       machine will give the best results. I have tuned the game for my
  80.       SparcStation 2 and it runs very fast. I cannot test the game on
  81.       other machines other the some Xterms and SGI Indigo's.  Disclamier.
  82.  
  83. This program DOESN'T have an Xdefaults file and does NOT use Motif or Xt. It
  84. is a plain XLIB program. It runs VERY fast on my computer which is a sparc II.
  85. If it is slow then check out the problems.doc doco.
  86.  
  87.  
  88. Where do I get it from
  89. ----------------------
  90.  
  91. Via anonymous ftp from [ftp.x.org] in the /contrib/games directory. 
  92.  
  93. The most recent version is xboing2.4.tar.gz
  94.  
  95. It may appear on other mirror archive machines  that mirror ftp.x.org or 
  96. whatever. In Australia try archie.au ftp.x.org will always have the latest.
  97.  
  98. You may like to check out my WWW Home Page for XBoing at the following URL
  99.  
  100.           http://www.catt.rmit.edu.au/xboing/xboing.html
  101.  
  102.  
  103. Unpacking the Archive
  104. ---------------------
  105.  
  106. There are three files you can get.
  107.  
  108. xboing2.4.tar.gz  = GNU zipped tar file. Use gunzip or gzip -d, then untar.
  109. xboing2.4.readme  = The README file you are reading!
  110.  
  111. Once you have uncompressed the archive then you must untar it. It will make
  112. a directory called xboing in your current directory. The way I untar the
  113. file is as follows:
  114.  
  115.          tar -xvfo xboing2.4.tar
  116.  
  117. You should then have the directory xboing and all the source etc. Read on.
  118.  
  119.  
  120. Installation/Building game
  121. --------------------------
  122.  
  123. Please read the file called INSTALL. It is important to read this file.
  124. Don't forget to get the XPM library and compile it up first! Please don't
  125. ask me how to compile XPM as it has really good installation documents.
  126.  
  127. NOTE: I do NOT SUPPORT the sound code subsystems. Check the source and 
  128.       email the authors for help. They will send me the new code if it
  129.       needs to be updated.
  130.  
  131. Usage
  132. -----
  133.  
  134. The game does have command line options so check them out. 'xboing -help'
  135.  
  136. The colourmap is taken over as I need all the colours. Sorry but thats the
  137. problem with only 256 colourmap entries. I cannot see a problem with this.
  138.  
  139. The colourmap is released afterwards and should return you to your lovely
  140. colour scheme. If it doesn't please let me know.
  141.  
  142.  
  143. Developement
  144. ------------
  145.  
  146. Xboing was developed on a SparcStation 2 with 48meg memory and a 19" colour
  147. display using the MIT X11R5 X server, fvwm window manager. I used x11ups 
  148. which is found on the archives as (UPS) for debugging - excellent tool. 
  149. Sunos 4.1.2/3 sun4c. Compiled using gcc with warnings on and also tested using 
  150. the Sun cc compiler (non ansi).
  151.  
  152. Reference books: All of O'Reilly Series, X & Motif Quick reference guide
  153. Graphics: Titles done on Amiga using Deluxe Paint IV, converted using pbmplus
  154.           tools and xpm image touch ups with "pixmap".
  155. Sounds:   Mainly from sounds.sdus.edu and also from other places.
  156.  
  157.  
  158. Special Thanks
  159. --------------
  160.  
  161. Really special thanks to Arnaud Le Hors (lehors@sophia.inria.fr) for the
  162. wonderful XPM library and for making it free :-).
  163.  
  164. Thanks for a some cool backgrounds found in Anthony's Icons - some copyright.
  165. Anthony Thyssen - anthony@cit.gu.edu.au
  166.  
  167. Please read the COPYRIGHT message in the backgrounds directory as some images
  168. are copyright and must NOT be used in a Microsoft Windows environment.
  169.  
  170. The comp.windows.x newsgroup netters for help over the past few years. See
  171. the changes.doc doco inline lisitings of the some of the many helpers.
  172.  
  173. Thankyou to those who have emailed me over the past year reporting bugs :-(
  174. and making me aware of your preferences.
  175.  
  176.  
  177. Patches to XBoing
  178. -----------------
  179.  
  180. Patches are great and welcomed. Please do as others have and either send them
  181. to me or post them to news. Please do NOT place them on ftp.x.org and
  182. make it look like I put it there. 
  183.  
  184.  
  185. Suggestions/Bug fixes
  186. ---------------------
  187.  
  188. I have had many suggestions and bug fixes. I cannot list all the names of the
  189. people who have helped as it would be a big list and I wouldn't want to
  190. leave anyone out. Thankyou to all those who have helped - you know. ;-)
  191.  
  192. See the changes.doc doco for more juicy info.
  193.  
  194.  
  195. Grovel Bit
  196. ----------
  197.  
  198. If anyone is feeling really generous or kind they can send money, equipment,
  199. cars, travel vouchers or anything for that matter to my humble self and I 
  200. will be very happy. ;) If that's all a bit much then a friendly email will
  201. do fine. 
  202.  
  203. Justin Kibell
  204. jck@catt.rmit.edu.au
  205. SnailMail: PO BOX 260 Eltham 3095 Victoria Australia
  206.